2. EL 6 ELS
  3. ccs
  4. ccs(8)

Scroll to navigation

CCS(8) System Manager's Manual CCS(8)

NAME

ccs - Cluster Configuration System

SYNOPSIS

ccs [-h hostname | -f filename] [options]

DESCRIPTION

ccs allows an administrator to create, modify and view a cluster configuration file on a remote node through ricci or on a local file system. Using ccs an administrator can also start and stop the cluster services on one or all of the nodes in a configured cluster.

OPTIONS

Generally all command lines must specify either a hostname or filename to act upon.

MAIN OPTIONS

Display this help and exit
Cluster node to perform actions on
If primary node name is unavailable, attempt to connect to ricci on the alt interface (only works from a cluster member)
File to perform actions on
Ignore validation errors in cluster.conf file
Ricci user password for node running ricci
Print current cluster.conf file
Use the file specified by '-f' to send to the host specified with '-h'
If file is specified, verify that all the nodes in the file have the same cluster.conf as the file. If a host is specified then verify that all nodes in the host's cluster.conf file have the identical
Print current cluster schema file (if using -h use schema from network, if using -f use local schema)
Sync config file to all nodes and optionally activating that configuration on all nodes
Activate config on node (use this option with --sync to activate config on all nodes)
Backup cluster.conf file before changes in ~/.ccs/backup directory
Display debugging information to help troubleshoot connection issues with ricci
Expert mode to add elements not currently defined in ccs
Expert mode to remove elements not currently defined in ccs

CLUSTER OPERATIONS

Create a new cluster.conf (removing old one if it exists)
Get the current cluster.conf version
Set the cluster.conf version
Increment the cluster.conf version by 1
Start *AND* enable cluster services on reboot on all nodes (if --noenable or --nodisable is specified cluster services will only be started)
Stop *AND* disable cluster services on reboot for all nodes (if --noenable or --nodisable is specified cluster services will only be stopped)
Start *AND* enable cluster services on reboot for host specified with -h or localhost if no host is provided (if --noenable or --nodisable is specified cluster services will only be started)
Stop *AND* disable cluster services on reboot for host specified with -h or localhost if no host is provided (if --noenable or --nodisable is specified cluster services will only be stopped)

NODE OPERATIONS

List all nodes in the cluster
Add node <node> to the cluster
Remove a node from the cluster
Specify nodeid when adding a node
Specify number of votes when adding a node
Add an altname to a node for RRP
Remove an altname from a node for RRP

FENCING OPERATIONS

List available fence devices. If a fence type is specified, then list options for the specified fence type
List all of the fence devices configured
List all of the fence methods and instances on the specified node or all nodes if no node is specified
Add a fence method to a specific node
Remove a fence method from a specific node
Add fence device. Fence devices and parameters can be found in online documentation in 'Fence Device Parameters'
Remove fence device
Add fence instance. Fence instance parameters can be found in online documentation in 'Fence Device Parameters'. Using --nounfence prevents ccs from automatically including an unfencing section for agents that require unfencing (ie. fence_scsi, fence_sanlock, etc.)

Remove all instances of the fence device listed from the given method and node
Add an unfence instance
Remove all instances of the fence device listed from the unfence section of the node

FAILOVER DOMAIN OPERATIONS

Lists all of the failover domains and failover domain nodes configured in the cluster
Add failover domain
Remove failover domain
Add node to given failover domain
Remove node from failover domain

SERVICE OPERATIONS

List available services. If a service type is specified, then list options for the specified service type
An alias to --lsserviceopts
List currently configured services and resources in the cluster
Add global cluster resources to the cluster Resource types and variables can be found in the online documentation under 'HA Resource Parameters'

Remove specified resource with resource options
Add service to cluster
Removes a service and all of its subservices
Add an action to the specified resource.
Remove all actions from resource, or actions matching action name and options specified
Adds a virtual machine to the cluster
Removes named virtual machine from the cluster
Add individual subservices, if adding child services, use ':' to separate parent and child subservices and brackets to identify subservices of the same type
Subservice types and variables can be found in the online documentation under 'HA Resource Parameters'
To add a nfsclient subservice as a child of the 2nd nfsclient subservice in the 'service_a' service use the following example:
ccs <...> --addsubservice service_a nfsclient[1]:nfsclient ref=/test
Removes a specific subservice specified by the subservice, using ':' to separate elements and brackets to identify between subservices of the same type.
To remove the 1st nfsclient child subservice of the 2nd nfsclient subservice in the 'service_a' service, use the following example:
ccs <...> --rmsubservice service_a nfsclient[1]:nfsclient

QUORUM OPERATIONS

List quorum options and heuristics
Add quorumd options
Add heuristics to quorumd
Remove heuristic specified by heurstic options

MISC OPTIONS

List all of the misc options
Set totem options
Set uidgid options
Remove uidgid entry matching specified uid/gid
Set dlm options
Set resource manager options
Set cman options
Sets the multicast address to use (or removes it if no multicast address is given)
Sets the alt multicast address to use (or removes it if no alt multicast address is given)
Set fence daemon options
Set logging options
Add a logging daemon (see cluster.conf for options)
Remove the logging daemon with the specified options

FILES

~/.ccs/cacert.config ~/.ccs/cacert.pem ~/.ccs/privkey.pem

Automatically generated certificate files used to authenticate with ricci.

EXAMPLES

Create and start a 3 node cluster with apc fencing:
ccs -h host1 --createcluster mycluster
ccs -h host1 --addnode host1
ccs -h host1 --addnode host2
ccs -h host1 --addnode host3
ccs -h host1 --addmethod primary host1
ccs -h host1 --addmethod primary host2
ccs -h host1 --addmethod primary host3
ccs -h host1 --addfencedev myfence agent=fence_apc ipaddr=192.168.0.200 login=apc passwd=apc
ccs -h host1 --addfenceinst myfence host1 primary port=1
ccs -h host1 --addfenceinst myfence host2 primary port=2
ccs -h host1 --addfenceinst myfence host3 primary port=3
ccs -h host1 --sync --activate
ccs -h host1 --startall

AUTHOR

Chris Feist <cfeist@redhat.com>

SEE ALSO

ricci(8), cluster.conf(5), ccs_tool(8)

NOTES

Fence Device Parameters http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Cluster_Administration/ap-fence-device-param-CA.html
HA Resource Parameters http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Cluster_Administration/ap-ha-resource-params-CA.html